<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>

    <title>Book Browser</title>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
  <link href="../../stylesheet.css" type="text/css" rel="stylesheet"/>
<link href="../../page_styles1.css" type="text/css" rel="stylesheet"/>

  


<link href="../../calibreHtmlOutBasicCss.css" type="text/css" rel="stylesheet" />

</head>
<body>

<div class="calibreMeta">
  <div class="calibreMetaTitle">
  
  
    
    <h1>
      <a href="../../../index.html">Sigil User Guide
</a>
    </h1>
    
    
  
  </div>
  <div class="calibreMetaAuthor">
    0.7.2

  </div>
</div>

<div class="calibreMain">

  <div class="calibreEbookContent">
    
      <div class="calibreEbNavTop">
        
          <a href="preview.html" class="calibreAPrev">previous page</a>
        

        
          <a href="metadata.html" class="calibreANext"> next page</a>
        
      </div>
    

    
  <div class="calibre9"></div><h2 id="book_browser" class="calibre5">Book Browser</h2>

  <p class="h2subheading">— Managing files in Your EPUB—</p>

  <p class="calibre1">All of the files that make up your EPUB can be accessed using the Book Browser. Your text files, images, as well as any fonts or stylesheets or other files, are organised into folders – allowing easy access to open and edit them with a double-click, or to right-click on them to perform actions.</p>

  <p class="calibre1">The Book Browser is usually open, but you can open it by selecting the menu item <span class="shortcut">View→Book Browser</span>:</p>

  <div class="image"><img alt="book-browser-main" src="../Images/book-browser-main.png" class="calibre7"/></div>

  <div class="tip">
    <p class="tiptext">Double-clicking a file will open it in a tab in the editing window.</p>

    <p class="tiptext">Right-clicking on a file name displays a context menu of options.</p>
  </div>

  <h3 class="sigilnotintoc" id="folders_and_files">Folders &amp; Files</h3>

  <p class="calibre1">The Book Browser organises your files into several folders which can be expanded or collapsed by clicking on the little arrow or plus icon to the left of the folder’s name or double-clicking on the folder name. The folders and files include:</p>

  <ul class="calibre3">
    <li class="calibre4"><span class="listheading">Text:</span> The XHTML, HTML, XML, HTM files that make up the text of the book.</li>

    <li class="calibre4"><span class="listheading">Styles:</span> The CSS stylesheets that control the formatting of the book.</li>

    <li class="calibre4"><span class="listheading">Images:</span> The PNG, JPG, GIF, SVG image files in the book.</li>

    <li class="calibre4"><span class="listheading">Fonts:</span> The TTF and OTF embedded fonts that might be in the book.</li>

    <li class="calibre4"><span class="listheading">Audio:</span> The MP3, AAC, MPG, MPEG, M4A embedded audio files that might be in the book.</li>

    <li class="calibre4"><span class="listheading">Video:</span> The MP4, OGG, WEBM, M4V embedded video files that might be in the book.</li>

    <li class="calibre4"><span class="listheading">Misc:</span> Other files, which are not typically used by EPUB readers even though they can be stored with the book.</li>

    <li class="calibre4"><span class="listheading">toc.ncx:</span> The file containing the table of contents of the book.</li>

    <li class="calibre4"><span class="listheading">content.opf:</span> The file containing the list of files in the book.</li>
  </ul>

  <p class="calibre1">To open a file just double-click the file name. If the file was not already open in a tab, a new tab will be created for it. If it was already open in a tab the view will switch to the tab containing the file.</p>

  <div class="tip">
    <p class="tiptext">If you change tabs, the Book Browser will select the file used by the tab.</p>

    <p class="tiptext">The tooltip for each folder name shows the number of files in the folder. The tooltip for each file shows the full file name and any guide semantic types it has.</p>
  </div>

  <h3 class="sigilnotintoc" id="selecting_multiple_files">Selecting Multiple Files</h3>

  <p class="calibre1">You can select multiple files in the Book Browser by clicking on one entry, and then holding the <span class="shortcut">Shift</span> key while clicking another entry to select all entries between and including the two entries. Hold down the <span class="shortcut">Ctrl</span> key while clicking to add individual files to your selection. You can also use the right-click context menu entry <span class="shortcut">Select All</span> to select all entries easily. Once you have selected your files you can then use the right-click context menu to perform actions on all the selected files.</p>

  <p class="calibre1">You can only select multiple items within the same folder.</p>

  <h3 class="sigilnotintoc" id="re-ordering_files">Re-Ordering Files</h3>

  <p class="calibre1">The order of the files in the Text folder is important since it is the order in which the files will be displayed to readers.</p>

  <p class="calibre1">You can drag a file in the Text folder and move it up or down if you need to re-arrange the order in which the chapters or files appear in your book.</p>

  <div class="tip">
    <p class="tiptext">You can also use the context menu to rename or re-sort the files.</p>
  </div>

  <p class="calibre1">All other folders are automatically sorted alphabetically and cannot be re-arranged – the order of their files does not affect how your book is displayed.</p>

  <h3 class="sigilnotintoc" id="context_menu">Context Menu</h3>

  <p class="calibre1">Right-clicking on one or more items in the Book Browser brings up a context menu with relevant actions:</p>

  <div class="image"><img alt="book-browser-context-menu" src="../Images/book-browser-context-menu.png" class="calibre7"/></div>

  <p class="calibre1">The following sections describe the available context menu actions.</p>

  <h3 class="sigilnotintoc" id="context_add_existing"/>

  <h3 class="sigilnotintoc">Delete</h3>

  <p class="calibre1">Delete the selected files. You cannot delete the last remaining HTML file.</p>

  <p class="calibre1">You will be prompted to confirm you want to delete the files since the action cannot be undone.</p>

  <div class="image"><img alt="book-browser-delete-files" src="../Images/book-browser-delete-files.png" class="calibre7"/></div>

  <p class="calibre1">Remember to update or regenerate the Table of Contents if your file was included in the TOC.</p>

  <h3 class="sigilnotintoc" id="book_browser_rename">Rename</h3>

  <p class="calibre1">If you select a single file to rename, then the name of the file is highlighted so that you can type in its new name. By default the extension is not highlighted to make renaming easier, but you can also change the extension if necessary.</p>

  <p class="calibre1">If you select multiple files, then a new dialog is displayed asking you how you want to rename the files:</p>

  <div class="image"><img alt="book-browser-rename-files" src="../Images/book-browser-rename-files.png" class="calibre7"/></div>

  <p class="calibre1">Enter the name the first file should have, including numbers at the end of the name. Sigil will then name each of your files sequentially using the name you provided and starting at the number you provided. A file will not be renamed if it would result in the book having duplicate file names. You can also rename the extension.</p>

  <p class="calibre1">For example:</p>

  <div class="indent1">
    <dl class="calibre1">
      <dt class="calibre8"><span class="example">Chapter 1</span></dt>

      <dd class="calibre11">Will rename the files to: <span class="example">Chapter 1, Chapter 2, Chapter 3 …</span> but will not change the file extension.</dd>

      <dt class="calibre8"><span class="example">Section_0099</span></dt>

      <dd class="calibre11">Will rename the files to: <span class="example">Section_0099, Section 0100, Section_0101 ….</span></dd>

      <dt class="calibre8"><span class="example">Part 2 – Section 08</span></dt>

      <dd class="calibre11">Will rename the files to: <span class="example">Part 2 – Section 08, Part 2 – Section 09, Part 2 – Section 10 ….</span></dd>

      <dt class="calibre8"><span class="example">.xhtml</span></dt>

      <dd class="calibre11">Will rename only the file extension of all files to: <span class="example">.xhtml.</span></dd>

      <dt class="calibre8"><span class="example">Section_0099.xhtml</span></dt>

      <dd class="calibre11">Will rename the files to: <span class="example">Section_0099.xhtml, Section 0100.xhtml, Section_0101.xhtml ….</span></dd>
    </dl>
  </div>

  <div class="tip">
    <p class="tiptext">When you rename a file, any links pointing to the file in your EPUB will be updated.</p>
  </div>

  <h3 class="sigilnotintoc">Merge</h3>

  <p class="calibre1">If you select a single HTML file, then the file will be merged into the previous HTML file in the list.</p>

  <p class="calibre1">If you select multiple HTML files, then all files will be merged into the first HTML file you selected.</p>

  <p class="calibre1">You can also use the Merge keyboard shortcut. See the <a href="../Text/splitting_and_merging.html">Splitting and Merging</a> chapter for more details.</p>

  <h3 class="sigilnotintoc">Sort</h3>

  <p class="calibre1">Sort the selected HTML files alpha-numerically. This means filenames containing numbers will be sorted in their expected numerical order, e.g. “1 3 2 10” will be resorted as “1 2 3 10” instead of the default “1 10 2 3”.</p>

  <h3 class="sigilnotintoc">Link Stylesheets</h3>

  <p class="calibre1">Link Stylesheets to the selected HTML files. Choose the stylesheets to link from the dialog window – only stylesheets marked with a checkmark will be linked, others will be unlinked from the HTML file.</p>

  <div class="image"><img alt="book-browser-link-stylesheets" src="../Images/book-browser-link-stylesheets.png" class="calibre7"/></div>

  <div class="tip">
    <p class="tiptext">When the dialog is first opened a checkmark is shown against stylesheets only if all selected files are linked to that stylesheet.</p>

    <p class="tiptext">Stylesheets are applied in the order listed when the document is rendered.</p>
  </div>

  <h3 class="sigilnotintoc" id="add-semantics">Add Semantics</h3>

  <p class="calibre1">This sub-menu allows you to designate the semantic "type" for selected files. EPUB ereaders may use this information (stored in the <span class="example">content.opf file</span>) to guide them in how to present these files to readers.</p>

  <p class="calibre1">For Image files, the only option is <span class="shortcut">Cover</span> – to indicate that this image is the cover image of the book.</p>

  <p class="calibre1">For HTML files you can select from any of the following options – but each file can have only one type:</p>

  <ul class="calibre3">
    <li class="calibre4">Cover</li>

    <li class="calibre4">TitlePage</li>

    <li class="calibre4">Table Of Contents</li>

    <li class="calibre4">Index</li>

    <li class="calibre4">Glossary</li>

    <li class="calibre4">Acknowledgements</li>

    <li class="calibre4">Bibliography</li>

    <li class="calibre4">Colophon</li>

    <li class="calibre4">Copyright Page</li>

    <li class="calibre4">Dedication</li>

    <li class="calibre4">Epigraph</li>

    <li class="calibre4">Foreword</li>

    <li class="calibre4">List Of Illustrations</li>

    <li class="calibre4">List Of Tables</li>

    <li class="calibre4">Notes</li>

    <li class="calibre4">Preface</li>

    <li class="calibre4">Text</li>
  </ul>

  <div class="tip">
    <p class="tiptext"><span class="menuitem">Text</span> should be used to indicate the page of the book that should be shown when the book is first opened, but not all ereaders follow this convention.</p>
  </div>

  <h3 class="sigilnotintoc" id="context_open_with">Open With</h3>

  <p class="calibre1">Opens a dialog window to allow you to choose an external application to edit this file.</p>

  <p class="calibre1">See the <a href="../Text/external_editors.html">External Editors</a> chapter for more details.</p>

  <h3 class="sigilnotintoc" id="context_save_as">Save As</h3>

  <p class="calibre1">Allows you to save the selected files to your computer in case you need to access them outside of the EPUB.</p>

  <h3 class="sigilnotintoc" id="context_add_blank">Add Blank HTML File/Stylesheet/SVG Image</h3>

  <p class="calibre1">Adds a blank HTML document, CSS Stylesheet, or SVG Image file to the folder. For HTML it will add just below the file you right-clicked on, or at the bottom of the folder if you right-clicked on the folder name. For other folders it will add them in alphabetical order.</p>

  <p class="calibre1">This is the same as the main menu item <span class="shortcut">File→Add.</span></p>

  <p class="calibre1">The new file will be numbered with the lowest available number starting from <span class="example">0001</span> (e.g. <span class="example">Section0001.html</span>), and you can then rename it.</p>

  <h3 class="sigilnotintoc" id="context_add_copy">Add Copy</h3>

  <p class="calibre1">Creates a copy of the HTML file you clicked on and adds it to the folder.</p>

  <h3 class="sigilnotintoc" id="context_add_existing_files">Add Existing Files</h3>

  <p class="calibre1">Opens a dialog window to allow you to choose one or more files from your computer to add to your EPUB.</p>

  <p class="calibre1">Files will be added to the appropriate folder based on their file extension regardless of what file you right-clicked on.</p>

  <p class="calibre1">This is the same as the main menu item <span class="shortcut">File→Add→Existing Files</span> and the Add Existing toolbar button.</p>

  <h3 class="sigilnotintoc" id="select_all">Select All</h3>

  <p class="calibre1">A quick way to select all of the files in the current folder so you can rename, link, etc. all of them at once.</p>

  <h3 class="sigilnotintoc" id="font_obfuscation">Font Obfuscation</h3>

  <p class="calibre1">If you are using custom fonts in your ebook, then this Font folder sub-menu allows you to define how the embedded fonts are stored in the EPUB. Normally when fonts are added to the EPUB the fonts are stored in a readable form. In some cases you may not want to make the fonts available for the readers to access directly. In these cases you can obfuscate or scramble the fonts in the ebook so that readers cannot access the fonts, but the fonts will still be useable by EPUB ereaders. The details of obfuscation and its implications are beyond the scope of this guide, but there are many references to it on the web.</p>

  <p class="calibre1">The options are:</p>

  <ul class="calibre3">
    <li class="calibre4">None</li>

    <li class="calibre4">Use Adobe’s Method</li>

    <li class="calibre4">Use IDPF’s Method</li>
  </ul>

  <div class="calibre8">
    The method will have a checkmark next to it if all selected fonts use that method.
  </div>

  <h3 class="sigilnotintoc">Renumber TOC Entries</h3>

  <p class="calibre1">An advanced feature that sequentially renumbers the playOrder and navPoint id numbers of the Table of Content entries in the <span class="example">toc.ncx</span> file starting from 1. This feature is intended to clean up the TOC numbering if you have to manually add or delete an entry in the TOC.</p>

  <p class="calibre1">You can also use the Edit TOC feature – just saving the TOC will renumber the ids.</p>

  <p class="calibre1">Any navList or pageList items in the file are not saved – only the Table of Contents entries are saved after renumbering.</p>



  </div>

  
  <div class="calibreToc">
    <h2><a href="../../../index.html"> Table of contents</a></h2>
     <div>
  <ul>
    <li>
      <a href="cover_picture.html">Cover</a>
    </li>
    <li>
      <a href="titlepage.html">Title Page</a>
    </li>
    <li>
      <a href="rights.html">Copyright</a>
    </li>
    <li>
      <a href="introduction.html">Introduction</a>
      <ul>
        <li>
          <a href="whats_new.html">What’s New</a>
        </li>
        <li>
          <a href="about_sigil.html">About Sigil</a>
        </li>
        <li>
          <a href="about_epub.html">About EPUB</a>
        </li>
      </ul>
    </li>
    <li>
      <a href="installation.html">Installation</a>
    </li>
    <li>
      <a href="features.html">Features</a>
      <ul>
        <li>
          <a href="user_interface.html">User Interface</a>
        </li>
        <li>
          <a href="preferences.html">Preferences</a>
        </li>
        <li>
          <a href="opening_and_saving_files.html">Opening and Saving Files</a>
        </li>
        <li>
          <a href="book_view.html">Book View</a>
        </li>
        <li>
          <a href="code_view.html">Code View</a>
        </li>
        <li>
          <a href="preview.html">Preview</a>
        </li>
        <li>
          <a href="book_browser.html">Book Browser</a>
        </li>
        <li>
          <a href="metadata.html">Metadata</a>
        </li>
        <li>
          <a href="add_cover.html">Add Cover</a>
        </li>
        <li>
          <a href="table_of_contents.html">Table of Contents</a>
        </li>
        <li>
          <a href="validation.html">Validation</a>
        </li>
        <li>
          <a href="spellcheck.html">Spellcheck</a>
        </li>
        <li>
          <a href="media_files.html">Images, Video, Audio</a>
        </li>
        <li>
          <a href="special_characters.html">Special Characters</a>
        </li>
        <li>
          <a href="splitting_and_merging.html">Splitting and Merging</a>
        </li>
        <li>
          <a href="find_replace.html">Find &amp; Replace</a>
        </li>
        <li>
          <a href="saved_searches.html">Saved Searches</a>
        </li>
        <li>
          <a href="clips.html">Clips</a>
        </li>
        <li>
          <a href="clipboard_history.html">Clipboard History</a>
        </li>
        <li>
          <a href="links.html">Links and IDs</a>
        </li>
        <li>
          <a href="styles.html">Styles</a>
        </li>
        <li>
          <a href="indexes.html">Indexes</a>
        </li>
        <li>
          <a href="reports.html">Reports</a>
        </li>
        <li>
          <a href="external_editors.html">External Editors</a>
        </li>
      </ul>
    </li>
    <li>
      <a href="tutorials.html">Tutorials</a>
      <ul>
        <li>
          <a href="tutorial_getting_started_with_epub.html">Getting Started With EPUB</a>
        </li>
        <li>
          <a href="tutorial_convert_to_html.html">Prepare Your File For Sigil</a>
        </li>
        <li>
          <a href="tutorial_load_file.html">Open Your File With Sigil</a>
        </li>
        <li>
          <a href="tutorial_save.html">Save Your EPUB File</a>
        </li>
        <li>
          <a href="tutorial_metadata.html">Add the Author and Title</a>
        </li>
        <li>
          <a href="tutorial_add_cover.html">Add a Cover Image</a>
        </li>
        <li>
          <a href="tutorial_split.html">Create Files For Each Chapter</a>
        </li>
        <li>
          <a href="tutorial_mark_chapters.html">Identify Your Chapters</a>
        </li>
        <li>
          <a href="tutorial_generate_toc.html">Generate A Table of Contents</a>
        </li>
        <li>
          <a href="tutorial_links.html">Create Links and Notes</a>
        </li>
        <li>
          <a href="tutorial_code_view.html">A Quick Introduction To Code View</a>
        </li>
        <li>
          <a href="tutorial_spelling.html">Check For Spelling Mistakes</a>
        </li>
        <li>
          <a href="tutorial_validate.html">Check For Errors In Your EPUB</a>
        </li>
        <li>
          <a href="tutorial_find_replace.html">Edit With Find &amp; Replace</a>
        </li>
        <li>
          <a href="tutorial_stylesheets.html">Use Stylesheets</a>
        </li>
        <li>
          <a href="tutorial_embed_fonts.html">Include Custom Fonts</a>
        </li>
        <li>
          <a href="tutorial_advanced_find.html">Advanced Find &amp; Replace – Regex</a>
        </li>
        <li>
          <a href="tutorial_regex_reference.html">Regular Expression Reference</a>
        </li>
        <li>
          <a href="tutorial_tips.html">Tips</a>
        </li>
      </ul>
    </li>
    <li>
      <a href="faq.html">FAQ</a>
      <ul>
        <li>
          <a href="faq.html#faq_common_questions">Common Questions</a>
        </li>
        <li>
          <a href="faq.html#faq_questions">Where to Get Help</a>
        </li>
        <li>
          <a href="faq.html#faq_using_sigil">Using Sigil</a>
        </li>
        <li>
          <a href="faq.html#faq_formatting">Formatting and Styles</a>
        </li>
      </ul>
    </li>
    <li>
      <a href="contributing_to_sigil.html">Contributing to Sigil</a>
    </li>
  </ul>
</div>


  </div>
  

  <div class="calibreEbNav">
    
      <a href="preview.html" class="calibreAPrev">previous page</a>
    

    <a href="../../../index.html" class="calibreAHome"> start</a>

    
      <a href="metadata.html" class="calibreANext"> next page</a>
    
  </div>

</div>

</body>
</html>
